QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

End Caps Masks

Some geometric objects (for example, cones and cylinders) have boundaries that delimit the object and that are distinct from the surface of the object itself. These boundaries are the object's end caps, of type TQ3EndCap .

The term end caps is potentially confusing, because it applies also to the interior portions of partial solids (that is, a solid object whose uMin field is greater than 0.0 or whose uMax field is less than 1.0).

When defining these geometric objects, you specify the kind of end caps by setting the caps field to some combination of these constants:

typedef enum TQ3EndCapMasks {
    kQ3EndCapNone                       = 0,
    kQ3EndCapMaskTop                    = 1 << 0,
    kQ3EndCapMaskBottom                 = 1 << 1,
    kQ3EndCapMaskInterior               = 1 << 2
} TQ3EndCapMasks;

Constant descriptions

kQ3EndCapNone
The specified geometric object has no end caps.
kQ3EndCapMaskTop
The specified geometric object has an end cap at the top.
kQ3EndCapMaskBottom
The specified geometric object has an end cap at the bottom.
kQ3EndCapMaskInterior
The specified geometric object has an end cap at the interior.

Some of these constants are not applicable to some geometric objects. For instance, the mask kQ3EndCapMaskTop , if set in the caps field of a cone, is ignored.


© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |